package jwcb.admin.server.map.service;


import jwcb.admin.api.map.domain.dto.CityLocationReqDto;
import jwcb.admin.api.map.domain.dto.PlaceSearchReqDto;
import jwcb.admin.server.map.domain.dto.SysRegionDTO;
import jwcb.admin.server.map.domain.dto.qq.RegionCityDTO;
import jwcb.admin.server.map.domain.dto.qq.SearchPoiDtTO;
import jwcb.javapjframework.common.domain.domain.dto.BasePageDTO;

import java.util.List;
import java.util.Map;

/**
 * 地图服务层接口
 */
public interface IMapService {

    /**
     * 城市列表查询
     * @return 城市列表信息
     */
    List<SysRegionDTO> getCityList();


    /**
     * 城市拼音归类查询
     * @return 城市字母与城市列表的哈希
     */
    Map<String, List<SysRegionDTO>> getCityPyList();


    /**
     * 根据父级区域ID获取子集区域列表
     * @param parentId 父级区域id
     * @return 子集区域列表
     */
    List<SysRegionDTO> getRegionChildrenList(Long parentId);


    /**
     * 获取热门城市列表
     * @return 热门城市列表
     */
    List<SysRegionDTO> getCityHotList();


    /**
     * 根据地点搜索
     * @param placeSearchReqDto 搜索条件
     * @return 搜索结果
     */
    BasePageDTO<SearchPoiDtTO> searchSuggestOnMap(PlaceSearchReqDto placeSearchReqDto);

    /**
     * 根据经纬度定位城市
     * @param cityLocationReqDto 定位信息
     * @return 城市信息
     */
    RegionCityDTO getCityLocation(CityLocationReqDto cityLocationReqDto);
}
